home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / documents / RFC / rfc1398.txt < prev    next >
Text File  |  1994-08-01  |  37KB  |  955 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                      F. Kastenholz
  8. Request for Comments: 1398                            FTP Software, Inc.
  9. Obsoletes: 1284                                             January 1993
  10.  
  11.  
  12.                    Definitions of Managed Objects for
  13.                    the Ethernet-like Interface Types
  14.  
  15. Status of this Memo
  16.  
  17.    This RFC specifies an IAB standards track protocol for the Internet
  18.    community, and requests discussion and suggestions for improvements.
  19.    Please refer to the current edition of the "IAB Official Protocol
  20.    Standards" for the standardization state and status of this protocol.
  21.    Distribution of this memo is unlimited.
  22.  
  23. Abstract
  24.  
  25.    This memo defines a portion of the Management Information Base (MIB)
  26.    for use with network management protocols in TCP/IP-based internets.
  27.    In particular, it defines objects for managing ethernet-like objects.
  28.  
  29. Table of Contents
  30.  
  31.    1. The Network Management Framework ......................    1
  32.    2. Objects ...............................................    2
  33.    2.1 Format of Definitions ................................    2
  34.    3. Overview ..............................................    3
  35.    4. Definitions ...........................................    4
  36.    4.1 The Ethernet-like Statistics Group ...................    4
  37.    4.2 The Ethernet-like Collision Statistics Group .........   11
  38.    4.3 802.3 Tests ..........................................   12
  39.    4.4 802.3 Hardware Chipsets ..............................   14
  40.    5. Change Log ............................................   14
  41.    6. Acknowledgements ......................................   16
  42.    7. References ............................................   16
  43.    8. Security Considerations ...............................   17
  44.    9. Author's Address ......................................   17
  45.  
  46. 1.  The Network Management Framework
  47.  
  48.    The Internet-standard Network Management Framework consists of three
  49.    components.  They are:
  50.  
  51.       STD 16/RFC 1155 [3] which defines the SMI, the mechanisms used for
  52.       describing and naming objects for the purpose of management.  STD
  53.       16/RFC 1212 [13] defines a more concise description mechanism,
  54.       which is wholly consistent with the SMI.
  55.  
  56.  
  57.  
  58. Kastenholz                                                      [Page 1]
  59.  
  60. RFC 1398                   Ethernet-Like MIB                January 1993
  61.  
  62.  
  63.       RFC 1156 [4] which defines MIB-I, the core set of managed objects
  64.       for the Internet suite of protocols.  STD 17/RFC 1213 [6] defines
  65.       MIB-II, an evolution of MIB-I based on implementation experience
  66.       and new operational requirements.
  67.  
  68.       STD 15/RFC 1157 [5] which defines the SNMP, the protocol used for
  69.       network access to managed objects.
  70.  
  71.    The Framework permits new objects to be defined for the purpose of
  72.    experimentation and evaluation.
  73.  
  74. 2.  Objects
  75.  
  76.    Managed objects are accessed via a virtual information store, termed
  77.    the Management Information Base or MIB.  Objects in the MIB are
  78.    defined using the subset of Abstract Syntax Notation One (ASN.1) [7]
  79.    defined in the SMI.  In particular, each object has a name, a syntax,
  80.    and an encoding.  The name is an object identifier, an
  81.    administratively assigned name, which specifies an object type.  The
  82.    object type together with an object instance serves to uniquely
  83.    identify a specific instantiation of the object.  For human
  84.    convenience, we often use a textual string, termed the OBJECT
  85.    DESCRIPTOR, to also refer to the object type.
  86.  
  87.    The syntax of an object type defines the abstract data structure
  88.    corresponding to that object type.  The ASN.1 language is used for
  89.    this purpose.  However, the SMI [3] purposely restricts the ASN.1
  90.    constructs which may be used.  These restrictions are explicitly made
  91.    for simplicity.
  92.  
  93.    The encoding of an object type is simply how that object type is
  94.    represented using the object type's syntax.  Implicitly tied to the
  95.    notion of an object type's syntax and encoding is how the object type
  96.    is represented when being transmitted on the network.
  97.  
  98.    The SMI specifies the use of the basic encoding rules of ASN.1 [8],
  99.    subject to the additional requirements imposed by the SNMP.
  100.  
  101. 2.1.  Format of Definitions
  102.  
  103.    Section 4 contains contains the specification of all object types
  104.    contained in this MIB module.  The object types are defined using the
  105.    conventions defined in the SMI, as amended by the extensions
  106.    specified in [13].
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Kastenholz                                                      [Page 2]
  115.  
  116. RFC 1398                   Ethernet-Like MIB                January 1993
  117.  
  118.  
  119. 3.  Overview
  120.  
  121.    Instances of these object types represent attributes of an interface
  122.    to an ethernet-like communications medium.  At present, ethernet-like
  123.    media are identified by three values of the ifType object in the
  124.    Internet-standard MIB:
  125.  
  126.           ethernet-csmacd(6)
  127.           iso88023-csmacd(7)
  128.           starLan(11)
  129.  
  130.    For these interfaces, the value of the ifSpecific variable in the
  131.    MIB-II [6] has the OBJECT IDENTIFIER value:
  132.  
  133.           dot3    OBJECT IDENTIFER ::= { transmission 7 }
  134.  
  135.    The definitions presented here are based on the IEEE 802.3 Layer
  136.    Management Specification [9], as originally interpreted by Frank
  137.    Kastenholz of Interlan in [10].  Implementors of these MIB objects
  138.    should note that the IEEE document explicitly describes (in the form
  139.    of Pascal pseudocode) when, where, and how various MAC attributes are
  140.    measured.  The IEEE document also describes the effects of MAC
  141.    actions that may be invoked by manipulating instances of the MIB
  142.    objects defined here.
  143.  
  144.    To the extent that some of the attributes defined in [9] are
  145.    represented by previously defined objects in the Internet- standard
  146.    MIB or in the Generic Interface Extensions MIB [11], such attributes
  147.    are not redundantly represented by objects defined in this memo.
  148.    Among the attributes represented by objects defined in other memos
  149.    are the number of octets transmitted or received on a particular
  150.    interface, the number of frames transmitted or received on a
  151.    particular interface, the promiscuous status of an interface, the MAC
  152.    address of an interface, and multicast information associated with an
  153.    interface.
  154.  
  155.    The relationship between an ethernet-like interface and an interface
  156.    in the context of the Internet-standard MIB is one-to-one.  As such,
  157.    the value of an ifIndex object instance can be directly used to
  158.    identify corresponding instances of the objects defined herein.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Kastenholz                                                      [Page 3]
  171.  
  172. RFC 1398                   Ethernet-Like MIB                January 1993
  173.  
  174.  
  175. 4.  Definitions
  176.  
  177.           RFC1398-MIB DEFINITIONS ::= BEGIN
  178.  
  179.  
  180.                IMPORTS
  181.                     Counter, Gauge
  182.                          FROM RFC1155-SMI
  183.                     transmission
  184.                          FROM RFC1213-MIB
  185.                     OBJECT-TYPE
  186.                          FROM RFC-1212;
  187.  
  188.           --  This MIB module uses the extended OBJECT-TYPE macro as
  189.           --  defined in RFC-1212.
  190.  
  191.           --  this is the MIB module for ethernet-like objects
  192.  
  193.           dot3    OBJECT IDENTIFIER ::= { transmission 7 }
  194.  
  195.           -- { dot3 1 } is obsolete and has been deleted.
  196.  
  197. 4.1.  The Ethernet-like Statistics Group
  198.  
  199.  
  200.           -- the Ethernet-like Statistics group
  201.  
  202.           -- Implementation of this group is mandatory
  203.  
  204.           dot3StatsTable   OBJECT-TYPE
  205.                SYNTAX    SEQUENCE OF Dot3StatsEntry
  206.                ACCESS    not-accessible
  207.                STATUS    mandatory
  208.                DESCRIPTION
  209.                          "Statistics for a collection of ethernet-like
  210.                          interfaces attached to a particular system."
  211.                ::= { dot3 2 }
  212.  
  213.  
  214.           dot3StatsEntry   OBJECT-TYPE
  215.                SYNTAX    Dot3StatsEntry
  216.                ACCESS    not-accessible
  217.                STATUS    mandatory
  218.                DESCRIPTION
  219.                          "Statistics for a particular interface to an
  220.                          ethernet-like medium."
  221.                INDEX     { dot3StatsIndex }
  222.                ::= { dot3StatsTable 1 }
  223.  
  224.  
  225.  
  226. Kastenholz                                                      [Page 4]
  227.  
  228. RFC 1398                   Ethernet-Like MIB                January 1993
  229.  
  230.  
  231.           Dot3StatsEntry ::= SEQUENCE {
  232.                dot3StatsIndex
  233.                     INTEGER,
  234.                dot3StatsAlignmentErrors
  235.                     Counter,
  236.                dot3StatsFCSErrors
  237.                     Counter,
  238.                dot3StatsSingleCollisionFrames
  239.                     Counter,
  240.                dot3StatsMultipleCollisionFrames
  241.                     Counter,
  242.                dot3StatsSQETestErrors
  243.                     Counter,
  244.                dot3StatsDeferredTransmissions
  245.                     Counter,
  246.                dot3StatsLateCollisions
  247.                     Counter,
  248.                dot3StatsExcessiveCollisions
  249.                     Counter,
  250.                dot3StatsInternalMacTransmitErrors
  251.                     Counter,
  252.                dot3StatsCarrierSenseErrors
  253.                     Counter,
  254.                dot3StatsFrameTooLongs
  255.                     Counter,
  256.                dot3StatsInternalMacReceiveErrors
  257.                     Counter
  258.           }
  259.  
  260.           dot3StatsIndex   OBJECT-TYPE
  261.                SYNTAX    INTEGER
  262.                ACCESS    read-only
  263.                STATUS    mandatory
  264.                DESCRIPTION
  265.                          "An index value that uniquely identifies an
  266.                          interface to an ethernet-like medium.  The
  267.                          interface identified by a particular value of
  268.                          this index is the same interface as identified
  269.                          by the same value of ifIndex."
  270.                ::= { dot3StatsEntry 1 }
  271.  
  272.  
  273.           dot3StatsAlignmentErrors   OBJECT-TYPE
  274.                SYNTAX    Counter
  275.                ACCESS    read-only
  276.                STATUS    mandatory
  277.                DESCRIPTION
  278.                          "A count of frames received on a particular
  279.  
  280.  
  281.  
  282. Kastenholz                                                      [Page 5]
  283.  
  284. RFC 1398                   Ethernet-Like MIB                January 1993
  285.  
  286.  
  287.                          interface that are not an integral number of
  288.                          octets in length and do not pass the FCS check.
  289.  
  290.                          The count represented by an instance of this
  291.                          object is incremented when the alignmentError
  292.                          status is returned by the MAC service to the
  293.                          LLC (or other MAC user). Received frames for
  294.                          which multiple error conditions obtain are,
  295.                          according to the conventions of IEEE 802.3
  296.                          Layer Management, counted exclusively according
  297.                          to the error status presented to the LLC."
  298.                REFERENCE
  299.                          "IEEE 802.3 Layer Management"
  300.                ::= { dot3StatsEntry 2 }
  301.  
  302.  
  303.           dot3StatsFCSErrors   OBJECT-TYPE
  304.                SYNTAX    Counter
  305.                ACCESS    read-only
  306.                STATUS    mandatory
  307.                DESCRIPTION
  308.                          "A count of frames received on a particular
  309.                          interface that are an integral number of octets
  310.                          in length but do not pass the FCS check.
  311.  
  312.                          The count represented by an instance of this
  313.                          object is incremented when the frameCheckError
  314.                          status is returned by the MAC service to the
  315.                          LLC (or other MAC user). Received frames for
  316.                          which multiple error conditions obtain are,
  317.                          according to the conventions of IEEE 802.3
  318.                          Layer Management, counted exclusively according
  319.                          to the error status presented to the LLC."
  320.                REFERENCE
  321.                          "IEEE 802.3 Layer Management"
  322.                ::= { dot3StatsEntry 3 }
  323.  
  324.  
  325.           dot3StatsSingleCollisionFrames   OBJECT-TYPE
  326.                SYNTAX    Counter
  327.                ACCESS    read-only
  328.                STATUS    mandatory
  329.                DESCRIPTION
  330.                          "A count of successfully transmitted frames on
  331.                          a particular interface for which transmission
  332.                          is inhibited by exactly one collision.
  333.  
  334.                          A frame that is counted by an instance of this
  335.  
  336.  
  337.  
  338. Kastenholz                                                      [Page 6]
  339.  
  340. RFC 1398                   Ethernet-Like MIB                January 1993
  341.  
  342.  
  343.                          object is also counted by the corresponding
  344.                          instance of either the ifOutUcastPkts or
  345.                          ifOutNUcastPkts object and is not counted by
  346.                          the corresponding instance of the
  347.                          dot3StatsMultipleCollisionFrames object."
  348.                REFERENCE
  349.                          "IEEE 802.3 Layer Management"
  350.                ::= { dot3StatsEntry 4 }
  351.  
  352.  
  353.           dot3StatsMultipleCollisionFrames   OBJECT-TYPE
  354.                SYNTAX    Counter
  355.                ACCESS    read-only
  356.                STATUS    mandatory
  357.                DESCRIPTION
  358.                          "A count of successfully transmitted frames on
  359.                          a particular interface for which transmission
  360.                          is inhibited by more than one collision.
  361.  
  362.                          A frame that is counted by an instance of this
  363.                          object is also counted by the corresponding
  364.                          instance of either the ifOutUcastPkts or
  365.                          ifOutNUcastPkts object and is not counted by
  366.                          the corresponding instance of the
  367.                          dot3StatsSingleCollisionFrames object."
  368.                REFERENCE
  369.                          "IEEE 802.3 Layer Management"
  370.                ::= { dot3StatsEntry 5 }
  371.  
  372.  
  373.           dot3StatsSQETestErrors   OBJECT-TYPE
  374.                SYNTAX    Counter
  375.                ACCESS    read-only
  376.                STATUS    mandatory
  377.                DESCRIPTION
  378.                          "A count of times that the SQE TEST ERROR
  379.                          message is generated by the PLS sublayer for a
  380.                          particular interface. The SQE TEST ERROR
  381.                          message is defined in section 7.2.2.2.4 of
  382.                          ANSI/IEEE 802.3-1985 and its generation is
  383.                          described in section 7.2.4.6 of the same
  384.                          document."
  385.                REFERENCE
  386.                          "ANSI/IEEE Std 802.3-1985 Carrier Sense
  387.                          Multiple Access with Collision Detection Access
  388.                          Method and Physical Layer Specifications"
  389.                ::= { dot3StatsEntry 6 }
  390.  
  391.  
  392.  
  393.  
  394. Kastenholz                                                      [Page 7]
  395.  
  396. RFC 1398                   Ethernet-Like MIB                January 1993
  397.  
  398.  
  399.           dot3StatsDeferredTransmissions   OBJECT-TYPE
  400.                SYNTAX    Counter
  401.                ACCESS    read-only
  402.                STATUS    mandatory
  403.                DESCRIPTION
  404.                          "A count of frames for which the first
  405.                          transmission attempt on a particular interface
  406.                          is delayed because the medium is busy.
  407.  
  408.                          The count represented by an instance of this
  409.                          object does not include frames involved in
  410.                          collisions."
  411.                REFERENCE
  412.                          "IEEE 802.3 Layer Management"
  413.                ::= { dot3StatsEntry 7 }
  414.  
  415.  
  416.           dot3StatsLateCollisions   OBJECT-TYPE
  417.                SYNTAX    Counter
  418.                ACCESS    read-only
  419.                STATUS    mandatory
  420.                DESCRIPTION
  421.                          "The number of times that a collision is
  422.                          detected on a particular interface later than
  423.                          512 bit-times into the transmission of a
  424.                          packet.
  425.  
  426.                          Five hundred and twelve bit-times corresponds
  427.                          to 51.2 microseconds on a 10 Mbit/s system. A
  428.                          (late) collision included in a count
  429.                          represented by an instance of this object is
  430.                          also considered as a (generic) collision for
  431.                          purposes of other collision-related
  432.                          statistics."
  433.                REFERENCE
  434.                          "IEEE 802.3 Layer Management"
  435.                ::= { dot3StatsEntry 8 }
  436.  
  437.  
  438.           dot3StatsExcessiveCollisions   OBJECT-TYPE
  439.                SYNTAX    Counter
  440.                ACCESS    read-only
  441.                STATUS    mandatory
  442.                DESCRIPTION
  443.                          "A count of frames for which transmission on a
  444.                          particular interface fails due to excessive
  445.                          collisions."
  446.  
  447.  
  448.  
  449.  
  450. Kastenholz                                                      [Page 8]
  451.  
  452. RFC 1398                   Ethernet-Like MIB                January 1993
  453.  
  454.  
  455.                REFERENCE
  456.                          "IEEE 802.3 Layer Management"
  457.                ::= { dot3StatsEntry 9 }
  458.  
  459.  
  460.           dot3StatsInternalMacTransmitErrors   OBJECT-TYPE
  461.                SYNTAX    Counter
  462.                ACCESS    read-only
  463.                STATUS    mandatory
  464.                DESCRIPTION
  465.                          "A count of frames for which transmission on a
  466.                          particular interface fails due to an internal
  467.                          MAC sublayer transmit error. A frame is only
  468.                          counted by an instance of this object if it is
  469.                          not counted by the corresponding instance of
  470.                          either the dot3StatsLateCollisions object, the
  471.                          dot3StatsExcessiveCollisions object, or the
  472.                          dot3StatsCarrierSenseErrors object.
  473.  
  474.                          The precise meaning of the count represented by
  475.                          an instance of this object is implementation-
  476.                          specific.  In particular, an instance of this
  477.                          object may represent a count of transmission
  478.                          errors on a particular interface that are not
  479.                          otherwise counted."
  480.                REFERENCE
  481.                          "IEEE 802.3 Layer Management"
  482.                ::= { dot3StatsEntry 10 }
  483.  
  484.  
  485.           dot3StatsCarrierSenseErrors   OBJECT-TYPE
  486.                SYNTAX    Counter
  487.                ACCESS    read-only
  488.                STATUS    mandatory
  489.                DESCRIPTION
  490.                          "The number of times that the carrier sense
  491.                          condition was lost or never asserted when
  492.                          attempting to transmit a frame on a particular
  493.                          interface.
  494.  
  495.                          The count represented by an instance of this
  496.                          object is incremented at most once per
  497.                          transmission attempt, even if the carrier sense
  498.                          condition fluctuates during a transmission
  499.                          attempt."
  500.                REFERENCE
  501.                          "IEEE 802.3 Layer Management"
  502.                ::= { dot3StatsEntry 11 }
  503.  
  504.  
  505.  
  506. Kastenholz                                                      [Page 9]
  507.  
  508. RFC 1398                   Ethernet-Like MIB                January 1993
  509.  
  510.  
  511.           -- { dot3StatsEntry 12 } is not assigned
  512.  
  513.           dot3StatsFrameTooLongs   OBJECT-TYPE
  514.                SYNTAX    Counter
  515.                ACCESS    read-only
  516.                STATUS    mandatory
  517.                DESCRIPTION
  518.                          "A count of frames received on a particular
  519.                          interface that exceed the maximum permitted
  520.                          frame size.
  521.  
  522.                          The count represented by an instance of this
  523.                          object is incremented when the frameTooLong
  524.                          status is returned by the MAC service to the
  525.                          LLC (or other MAC user). Received frames for
  526.                          which multiple error conditions obtain are,
  527.                          according to the conventions of IEEE 802.3
  528.                          Layer Management, counted exclusively according
  529.                          to the error status presented to the LLC."
  530.                REFERENCE
  531.                          "IEEE 802.3 Layer Management"
  532.                ::= { dot3StatsEntry 13 }
  533.  
  534.  
  535.  
  536.           -- { dot3StatsEntry 14 } is not assigned
  537.  
  538.  
  539.           -- { dot3StatsEntry 15 } is not assigned
  540.  
  541.           dot3StatsInternalMacReceiveErrors   OBJECT-TYPE
  542.                SYNTAX    Counter
  543.                ACCESS    read-only
  544.                STATUS    mandatory
  545.                DESCRIPTION
  546.                          "A count of frames for which reception on a
  547.                          particular interface fails due to an internal
  548.                          MAC sublayer receive error. A frame is only
  549.                          counted by an instance of this object if it is
  550.                          not counted by the corresponding instance of
  551.                          either the dot3StatsFrameTooLongs object, the
  552.                          dot3StatsAlignmentErrors object, or the
  553.                          dot3StatsFCSErrors object.
  554.  
  555.                          The precise meaning of the count represented by
  556.                          an instance of this object is implementation-
  557.                          specific.  In particular, an instance of this
  558.                          object may represent a count of receive errors
  559.  
  560.  
  561.  
  562. Kastenholz                                                     [Page 10]
  563.  
  564. RFC 1398                   Ethernet-Like MIB                January 1993
  565.  
  566.  
  567.                          on a particular interface that are not
  568.                          otherwise counted."
  569.                REFERENCE
  570.                          "IEEE 802.3 Layer Management"
  571.                ::= { dot3StatsEntry 16 }
  572.  
  573. 4.2.  The Ethernet-like Collision Statistics Group
  574.  
  575.  
  576.           -- the Ethernet-like Collision Statistics group
  577.  
  578.           -- Implementation of this group is optional; it is appropriate
  579.           -- for all systems which have the necessary metering
  580.  
  581.           dot3CollTable   OBJECT-TYPE
  582.                SYNTAX    SEQUENCE OF Dot3CollEntry
  583.                ACCESS    not-accessible
  584.                STATUS    mandatory
  585.                DESCRIPTION
  586.                          "A collection of collision histograms for a
  587.                          particular set of interfaces."
  588.                ::= { dot3 5 }
  589.  
  590.  
  591.           dot3CollEntry   OBJECT-TYPE
  592.                SYNTAX    Dot3CollEntry
  593.                ACCESS    not-accessible
  594.                STATUS    mandatory
  595.                DESCRIPTION
  596.                          "A cell in the histogram of per-frame
  597.                          collisions for a particular interface.  An
  598.                          instance of this object represents the
  599.                          frequency of individual MAC frames for which
  600.                          the transmission (successful or otherwise) on a
  601.                          particular interface is accompanied by a
  602.                          particular number of media collisions."
  603.                INDEX     { dot3CollIndex, dot3CollCount }
  604.                ::= { dot3CollTable 1 }
  605.  
  606.  
  607.  
  608.           Dot3CollEntry ::= SEQUENCE {
  609.                dot3CollIndex
  610.                     INTEGER,
  611.                dot3CollCount
  612.                     INTEGER,
  613.                dot3CollFrequencies
  614.                     Counter
  615.  
  616.  
  617.  
  618. Kastenholz                                                     [Page 11]
  619.  
  620. RFC 1398                   Ethernet-Like MIB                January 1993
  621.  
  622.  
  623.           }
  624.  
  625.  
  626.           dot3CollIndex   OBJECT-TYPE
  627.                SYNTAX    INTEGER
  628.                ACCESS    read-only
  629.                STATUS    mandatory
  630.                DESCRIPTION
  631.                          "The index value that uniquely identifies the
  632.                          interface to which a particular collision
  633.                          histogram cell pertains.  The interface
  634.                          identified by a particular value of this index
  635.                          is the same interface as identified by the same
  636.                          value of ifIndex."
  637.                ::= { dot3CollEntry 1 }
  638.  
  639.  
  640.           dot3CollCount   OBJECT-TYPE
  641.                SYNTAX    INTEGER (1..16)
  642.                ACCESS    read-only
  643.                STATUS    mandatory
  644.                DESCRIPTION
  645.                          "The number of per-frame media collisions for
  646.                          which a particular collision histogram cell
  647.                          represents the frequency on a particular
  648.                          interface."
  649.                ::= { dot3CollEntry 2 }
  650.  
  651.  
  652.           dot3CollFrequencies   OBJECT-TYPE
  653.                SYNTAX    Counter
  654.                ACCESS    read-only
  655.                STATUS    mandatory
  656.                DESCRIPTION
  657.                          "A count of individual MAC frames for which the
  658.                          transmission (successful or otherwise) on a
  659.                          particular interface is accompanied by a
  660.                          particular number of media collisions."
  661.                ::= { dot3CollEntry 3 }
  662.  
  663.  
  664. 4.3.  802.3 Tests
  665.  
  666.  
  667.       --  802.3 Tests
  668.  
  669.       -- The ifExtnsTestTable defined in RFC 1229 provides a common
  670.       -- means for a manager to test any interface corresponding to
  671.  
  672.  
  673.  
  674. Kastenholz                                                     [Page 12]
  675.  
  676. RFC 1398                   Ethernet-Like MIB                January 1993
  677.  
  678.  
  679.       -- a value of ifIndex.
  680.  
  681.       -- At this time, one well known test (testFullDuplexLoopBack) is
  682.       -- defined in RFC 1229.  For ethernet-like interfaces, this test
  683.       -- configures the MAC chip and executes an internal loopback
  684.       -- test of memory and the MAC chip logic.  This loopback test can
  685.       -- only be executed if the interface is offline.  Once the test
  686.       -- has completed, the MAC chip should be reinitialized for network
  687.       -- operation, but it should remain offline.
  688.  
  689.       -- If an error occurs during a test, the object ifExtnsTestResult
  690.       -- (defined in RFC 1229) will be set to failed(7).  The following
  691.       -- two OBJECT IDENTIFIERs may be used to provided more
  692.       -- information as values for the object ifExtnsTestCode in
  693.       -- RFC 1229:
  694.  
  695.           dot3Errors             OBJECT IDENTIFIER ::= { dot3 7 }
  696.  
  697.                                -- couldn't initialize MAC chip for test
  698.           dot3ErrorInitError     OBJECT IDENTIFIER ::= { dot3Errors 1 }
  699.  
  700.                                 -- expected data not received (or not
  701.                                 -- received correctly) in loopback test
  702.           dot3ErrorLoopbackError OBJECT IDENTIFIER ::= { dot3Errors 2 }
  703.  
  704.        -- Tests
  705.         --  TDR Test
  706.  
  707.        -- Another test, specific to ethernet-like interfaces with the
  708.        -- exception of 10BaseT and 10BaseF, is Time-domain Reflectometry
  709.            (TDR).
  710.        -- The TDR value may be useful in determining the approximate
  711.            distance
  712.        -- to a cable fault.  It is advisable to repeat this test to
  713.            check for
  714.        -- a consistent resulting TDR value, to verify that there is a
  715.           fault.
  716.  
  717.           dot3Tests   OBJECT IDENTIFIER ::= { dot3 6 }
  718.           dot3TestTdr OBJECT IDENTIFIER ::= { dot3Tests 1 }
  719.  
  720.        -- A TDR test returns as its result the time interval, measured
  721.        -- in 10 MHz ticks or 100 nsec units, between the start of
  722.        -- TDR test transmission and the subsequent detection of a
  723.        -- collision or deassertion of carrier.  On successful completion
  724.        -- of a TDR test, the appropriate instance of ifExtnsTestResult
  725.        -- contains the OBJECT IDENTIFIER of the MIB object which
  726.        -- contains the value of this time interval.
  727.  
  728.  
  729.  
  730. Kastenholz                                                     [Page 13]
  731.  
  732. RFC 1398                   Ethernet-Like MIB                January 1993
  733.  
  734.  
  735. 4.4.  802.3 Hardware Chipsets
  736.  
  737.  
  738.        --  802.3 Hardware Chipsets
  739.  
  740.        -- The object ifExtnsChipSet is provided in RFC 1229 to identify
  741.        -- the MAC hardware used to communcate on an interface.  The
  742.        -- following hardware chipsets are provided for 802.3:
  743.  
  744.   dot3ChipSets          OBJECT IDENTIFIER ::= { dot3 8 }
  745.   dot3ChipSetAMD        OBJECT IDENTIFIER ::= { dot3ChipSets 1 }
  746.   dot3ChipSetAMD7990    OBJECT IDENTIFIER ::= { dot3ChipSetAMD 1 }
  747.   dot3ChipSetAMD79900   OBJECT IDENTIFIER ::= { dot3ChipSetAMD 2 }
  748.  
  749.   dot3ChipSetIntel      OBJECT IDENTIFIER ::= { dot3ChipSets 2 }
  750.   dot3ChipSetIntel82586 OBJECT IDENTIFIER ::= { dot3ChipSetIntel 1 }
  751.   dot3ChipSetIntel82596 OBJECT IDENTIFIER ::= { dot3ChipSetIntel 2 }
  752.   dot3ChipSetSeeq       OBJECT IDENTIFIER ::= { dot3ChipSets 3 }
  753.   dot3ChipSetSeeq8003   OBJECT IDENTIFIER ::= { dot3ChipSetSeeq 1 }
  754.  
  755.   dot3ChipSetNational      OBJECT IDENTIFIER ::= { dot3ChipSets 4 }
  756.   dot3ChipSetNational8390  OBJECT IDENTIFIER ::=
  757.                                            { dot3ChipSetNational 1 }
  758.   dot3ChipSetNationalSonic OBJECT IDENTIFIER ::=
  759.                                            { dot3ChipSetNational 2 }
  760.  
  761.   dot3ChipSetFujitsu       OBJECT IDENTIFIER ::= { dot3ChipSets 5 }
  762.   dot3ChipSetFujitsu86950  OBJECT IDENTIFIER ::=
  763.                                            { dot3ChipSetFujitsu 1 }
  764.   dot3ChipSetFujitsu86960  OBJECT IDENTIFIER ::=
  765.                                            { dot3ChipSetFujitsu 2 }
  766.  
  767.        -- For those chipsets not represented above, OBJECT IDENTIFIER
  768.        -- assignment is required in other documentation, e.g., assignment
  769.        -- within that part of the registration tree delegated to
  770.        -- individual enterprises (see RFC 1155).
  771.  
  772.           END
  773.  
  774. 5.  Change Log
  775.  
  776.   (1)  Replace old "Historical Perspective" boilerplate with the
  777.        new "The Network Management Framework" boilerplate.
  778.  
  779.   (2)  Remove the "slime text".
  780.  
  781.   (3)  Updated the reference to the Interface Extensions mib to
  782.        reflect its new RFC status.
  783.  
  784.  
  785.  
  786. Kastenholz                                                     [Page 14]
  787.  
  788. RFC 1398                   Ethernet-Like MIB                January 1993
  789.  
  790.  
  791.   (4)  Change the status of the memo section to hold the new
  792.        suggested text.
  793.  
  794.   (5)  References in ASN.1 comments were changed from the [#]
  795.        form to name the actual document being referred to. These
  796.        references are now meaningful when the ASN.1 is read
  797.        outside of the RFC.
  798.  
  799.   (6)  The IMPORTS section of the ASN.1 has been updated to
  800.        reflect that the OBJECT-TYPE macro is imported from RFC-
  801.        1212.
  802.  
  803.   (7)  The the Generic Ethernet-like group, containing
  804.        dot3Index, dot3InitializeMac, dot3MacSubLayerStatus,
  805.        dot3MulticastReceiveStatus, dot3TxEnabled, and
  806.        dot3TestTdrValue has been deprecated as a result of the
  807.        implementation experience presented at the San Diego IETF
  808.        meeting.
  809.  
  810.   (8)  dot3StatsInRangeLengthErrors and
  811.        dot3StatsOutOfRangeLengthFields have been deprecated as a
  812.        result of the implementation experience presented at the
  813.        San Diego IETF meeting.
  814.  
  815.   (9)  Update the acknowledgements section to reflect this
  816.        document's history, etc.
  817.  
  818.   (10) REFERENCE clauses have been added to all of the MIB
  819.        objects which are being retained.
  820.  
  821.   12 August 1992
  822.  
  823.   (1)  Removed all deprecated objects.
  824.  
  825.   (2)  Rephrased the description of the TDR test OID to reflect
  826.        the fact that dot3TestTdrValue is no more.
  827.        ifExtnsTestResult still points to the object containing
  828.        the result, the text simply does not refer to
  829.        dot3TestTdrValue. I could have deleted the Test, but the
  830.        OID should then remain reserved. I figured that it would
  831.        be just as easy to rephrase the definition of the test.
  832.  
  833.   13 august 1992
  834.  
  835.   (1)  Add fuji. 86960
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842. Kastenholz                                                     [Page 15]
  843.  
  844. RFC 1398                   Ethernet-Like MIB                January 1993
  845.  
  846.  
  847. 6.  Acknowledgements
  848.  
  849.    This document was produced by the Ethernet MIB Working Group.
  850.  
  851.    This document is based on the Proposed Standard Ethernet MIB, RFC
  852.    1284 [14], of which John Cook of Chipcom was the editor.  The
  853.    Ethernet MIB Working Group gathered implementation experience of the
  854.    variables specified in RFC 1284 and used that information to develop
  855.    this revised MIB.
  856.  
  857.    RFC 1284, in turn, is based on a document written by Frank Kastenholz
  858.    of Interlan entitled IEEE 802.3 Layer Management Draft M compatible
  859.    MIB for TCP/IP Networks [10].  This document has been modestly
  860.    reworked, initially by the SNMP Working Group, and then by the
  861.    Transmission Working Group, to reflect the current conventions for
  862.    defining objects for MIB interfaces.  James Davin, of the MIT
  863.    Laboratory for Computer Science, and Keith McCloghrie of Hughes LAN
  864.    Systems, contributed to later drafts of this memo. Marshall Rose of
  865.    Performance Systems International, Inc. converted the document into
  866.    its current concise format. Anil Rijsinghani of DEC contributed text
  867.    that more adequately describes the TDR test.  Thanks to Frank
  868.    Kastenholz of Interlan and Louis Steinberg of IBM for their
  869.    experimentation.
  870.  
  871. 7.  References
  872.  
  873.    [1] Cerf, V., "IAB Recommendations for the Development of Internet
  874.        Network Management Standards", RFC 1052, NRI, April 1988.
  875.  
  876.    [2] Cerf, V., "Report of the Second Ad Hoc Network Management Review
  877.        Group", RFC 1109, NRI, August 1989.
  878.  
  879.    [3] Rose M., and K. McCloghrie, "Structure and Identification of
  880.        Management Information for TCP/IP-based internets", STD 16, RFC
  881.        1155, Performance Systems International, Hughes LAN Systems, May
  882.        1990.
  883.  
  884.    [4] McCloghrie K., and M. Rose, "Management Information Base for
  885.        Network Management of TCP/IP-based internets", RFC 1156, Hughes
  886.        LAN Systems, Performance Systems International, May 1990.
  887.  
  888.    [5] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  889.        Network Management Protocol", STD 15, RFC 1157, SNMP Research,
  890.        Performance Systems International, Performance Systems
  891.        International, MIT Laboratory for Computer Science, May 1990.
  892.  
  893.    [6] Rose M., Editor, "Management Information Base for Network
  894.        Management of TCP/IP-based internets: MIB-II", STD 17, RFC 1213,
  895.  
  896.  
  897.  
  898. Kastenholz                                                     [Page 16]
  899.  
  900. RFC 1398                   Ethernet-Like MIB                January 1993
  901.  
  902.  
  903.        Performance Systems International, March 1991.
  904.  
  905.    [7] Information processing systems - Open Systems Interconnection -
  906.        Specification of Abstract Syntax Notation One (ASN.1),
  907.        International Organization for Standardization, International
  908.        Standard 8824, December 1987.
  909.  
  910.    [8] Information processing systems - Open Systems Interconnection -
  911.        Specification of Basic Encoding Rules for Abstract Notation One
  912.        (ASN.1), International Organization for Standardization,
  913.        International Standard 8825, December 1987.
  914.  
  915.    [9] IEEE, "IEEE 802.3 Layer Management", November 1988.
  916.  
  917.   [10] Kastenholz, F., "IEEE 802.3 Layer Management Draft compatible MIB
  918.        for TCP/IP Networks", electronic mail message to mib-
  919.        wg@nnsc.nsf.net, 9 June 1989.
  920.  
  921.   [11] McCloghrie, K., Editor, Extensions to the Generic-Interface MIB,
  922.        RFC 1229, Hughes LAN Systems, Inc., May 1991.
  923.  
  924.   [12] IEEE, "Carrier Sense Multiple Access with Collision Detection
  925.        (CSMA/CD) Access Method and Physical Layer Specifications",
  926.        ANSI/IEEE Std 802.3-1985.
  927.  
  928.   [13] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  929.        STD 16, RFC 1212, Performance Systems International, Hughes LAN
  930.        Systems, March 1991.
  931.  
  932.   [14] Cook, J., Editor, "Definitions of Managed Objects for Ethernet-
  933.        Like Interface Types", RFC 1284, Chipcom Corporation, December
  934.        1991.
  935.  
  936. 8.  Security Considerations
  937.  
  938.    Security issues are not discussed in this memo.
  939.  
  940. 9.  Author's Address
  941.  
  942.    Frank Kastenholz
  943.    2 High Street
  944.    North Andover, MA 01845-2620
  945.  
  946.    Phone: (508) 685-4000
  947.    EMail: kasten@ftp.com
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954. Kastenholz                                                     [Page 17]
  955.